MEDIT OCT. 12TH VERSION 

*************************** 





The supplied diskette contains* 

1. DOS 2S 

2. MEDIT (Mike's editor) 

3. MFQRMS (Dale's forns program) 


Notes on MEDIT 



To use the editor, use the "L- binary load" command in DOS. 
The editor will sign-on and prompt for a filename to edit. If the 
file you specify does not exist, the editor will create it. If 
only a filename is given. "DJ" is assumed. Be careful to check 
that there is enough free space on the disk to hold both a copy of 
the file you would like to edit and any additions you plan to make 
during the edit. 


Note that a disk full error (error 162) is fatal in the 
editor. In fact, all I/O errors are FATAL in this version. You 
are advised to exit and re-enter the editor every 15 minutes (or 
so) of editing. That way if the ststem or editor dies you have 
only lost up to 15 minutes of work. 

When errors or error warnings occur the keyboard speaker beeps 
and the error message is displayed in the error window. In this 
version the error message stays in the window until another error 
occurs or you delete a character in the command window. If errors 
occur that are internal to the editor (i.e. EDITOR IS CONFUSED) the 
keyboard ignores keystrokes until the secret key is typed. The 
secret key is CTRL. CLEAR. Usually a series of CTRL. CLEAR's will 
restore the editor. If not, try to EXIT or ABORT. If this type of 
error happens, PLEASE try to find a repeatable sequence that leads 
up to the error and tell me about it. 

% 

The editor should be as advertised in the Oct* 12th 
docunentat ion J except ♦ 

- The CBF connand should not be used* 

- If an error occurs while executing the connand line* the 
eoMMand line cursor is left in the connand window* 

~ Delete-left (or Delete-before) does not work fron the hone 
position and should not be attenpted* 

- I/O errors are FATAL.* 

- Any others bugs are virgins and should be reported to ne* 


note: 


using MEM*SAV while editting nay crash BASIC* 
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OCT ♦ 12TH VERSION 


? 


Notes or. MFORMS 



MFORMS is My Modified version of Dale's forMS prograM version 
2*2* This prograM forMatted the docuMer.tat ion for the editor* To 
use this prograM type 'RUN "D. MFORMS' while in BASIC. The prograM 
asks for an input filej you supply the filenane preceeded by "DJ" . 
The prograM then asks for an output filej you supply "PJ" or 3 - 
filer.aMe proceeded by "D { " ♦ If the output is sent to a file it can 
be later copied to the printer by using the DOS "C - copy to,froM" 

COMM3r.d ♦ 

p 

While using MEDIT to enter your text* I suggest you have each 
sentence followed by a space. CR coMbinat ion ♦ This allows for easy 
insertion or deletetior. of text later. Also the fornatter will put 
two spaces before starting a new sentence for better readability. 
Note that a blank line (two CR's in a row) in the input file flags 
the for Matter to quit. 
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A SOURCE FILE EDITOR 
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INTRODUCTION 


••• • ««»> MM M«« MM MM MM MM c 


MEDIT is a source file editor* A source file is defined to be 
3 disk file consisting of line(s) of ATASCI characters terminated 
by ATASCI n E0L u/ s* The maximum length of any line as far as MEDIT 
is concerned is 199 columns* This value may be reduced by the 
user* Tabs can be treated the way the Operating System treats them 
( s u b s t i t u t i n g n b 1 a n k s t o t h e n e x t t a b s t o p ) o r a s e x p a n ding tabs* 
Expanding Tabs are tabs that only take one character in the file 
but are displayed as many columns of blanks* MEDIT uses no line 
numbers ♦ 


MEDIT divides the screen into three windows* The first window 
is the text window and is 20 lines long* The second window is the 


error window which is a single line long* 
command window and is three lines long* 


The third window is the 


The text window displays up to 800 characters around the 
cursor* The window is updated instantly after every command to 
r e f ]. e c t t h e c u r r e n t s t a t e o f t h e file* 

The error window displays the last error that occured or 
prompts the user to answer MEDIT 's questions* 

The command window displays a single command line made of one 
or more commands* MEDIT allows more than one command line* but 
only displays the one you select* 


MEDIT uses the common two-file method of editing* Text is 
copied from the file to be editted into the memory buffer where 
text can be added* deleted* or modified* When the memory buffer 
becomes full it is written to a temporary file* This process is 
repeated until all text has been copied from the editted file into 
the temporary file* Upon normal exit the *BAK file is deleted* the 
editted file is renamed as the new *BAK file* and the temporary 
file is renamed as the editted file* Upon abnormal exit the 
temporary file is deleted and the original editted file and *Bi 
are untouched ♦ 
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IMMEDIATE MODE 



I^Mediate Mode refers to reserved keystrokes that immediately 
e x e c u t e a conna n d $ a n y r e n a i n i n g k e y s t r o k e s a r e i n s e r t e d d i r e c 1 1 y 
i i "i t o t h e t e x t a t t h e c u r- r e n t c u r s o r p o s i t i o n * B y u s i n g t h e 
s t a n d a r d e s c a p e s e q u e n e e a n y o f t h e 2 5 6 p o s s i b 1 e c h a r a c t e r s c an be 
i ri s e r t e d i n to t h e t e x t ♦ A f t e T' a n y k e y s t r o k e t h e t e x t w i n d o w i s 

updated to reflect the current state of the file* 


If the cursor is inside a expanding tab or to the right of a 
C R w h e n a c h a r a c t e r i s i n s e r t e d t h e e d i t o r w i 3. 1 a u t o m a t i c a 1 3. y p a d 
b 1 a n k s t o t h e 1 e f t , i n s e r t t h e c h a r a c t e T' *■ a n d m o v e t h e t a b t o t h e 
right of the cursor* 


IMMEDIATE MODE RESERVED KEYSTROKES 


ctr 1 ♦ 
ctr 1 ♦ 
ctr 1 ♦ 
ctr 1 ♦ 
ctr 1 ♦ 
Ctrl* 3 
backspace 


left arrow 
right arrow 
down arrow 
up arrow 
2 


ctr 1 ♦ 

delete 

shif t 

delete 

shift 

insert 

ctr 1 ♦ 

clear 

ctr 1 ♦ 

insert 

tab 


shift 

tab 

ctr 1 ♦ 

tab 


start 

select 

option 

break 

all other keystrokes 
position 


k 

x< 

)K 

)K 

W, 

>K 

X< 

W. 

K 

>K 

)K 

X; 

X< 

* 

& 

X< 

X< 

& 

)K 

)K 


nove 

Move 

Move 

Move 

Move 

Move 


cursor- 
cursor 
cursor 
c u r s o r 
cursor 
c u v s o r 


1 e f t ( s k i p a c t- o s s t a b s ) 
r i g h t ( s k i p a c r o s s t a b s ) 
d o w n o ri e p h y s i c a 3. 1 i n e 
u p o n e p h y s i. e a 1 1 i n e 
t o b e g i i' i ri i. n g o f 3. o g i c a 1 1 i n e 
to end of logical line 
delete character left of cursor 
d e 1 e t e c h a r a c t e r i g h t o f c u r s o r 
delete logical line cursor is on 
P r e p a r e t o i ri s e r t a n e w 3. i n e ( s ) 
d i si- p 1 a y p r i o r s c r e e n -• f u 3. 3. o f c h a T' cJ t e r s 
d i f> 1 y n e x t s c t' e e n - f u 1 1 o f c h a r a c t e r s 
tab to next tab stop 
toggle " visible-tab-MOde 11 
toggle ' ' v i si- i b 1 e - c r - m o d e 1 1 

e e c. % u t e c o m m a ri d < ) i n c o m m a n d w i n d o w 

s e 1 e c t s a d i f f e r e ri t c o m m a n d 1 i ri e 
e r a a e c o m m a r i d w i ri d o w -• e n t e r c o m m a n d m o d e 
does nothing (NOP) j 

entered directly into text at cursor 




vui 
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CTRL. LEFT ARROW 


cursor left 


This coMMsnd Moves the cursor left one position except if the 
character to the left is a tab character while expanding tabs are 
enabled. If this exception is Met the cursor will Move comp lately 
over the expanded tab. If the cursor is Moved above the text 
window an autoMatic scroll will pull down the previous line. To 
cursor left while already at the beginning of the text in the 
buffer will result in no operation except an error warning. "CURSOR 
AT END." 


CTRL. RIGHT ARROW - CURSOR RIGHT 

This coMMarid Moves the cursor right one position except if the 
character to the right is a tab character while expanding tabs are 
enabled. If this exception is Met the cursor will Move comp lately 
over the expanded tab. If the cursor is Moved below the text 
window an autoMatic scroll will pull up the next line. To cursor 
right while already at the end of the text in the buffer will 
result in no operation except an error warning. "CURSOR AT END." 


CTRL. UP ARROW 


CURSOR UP 


This coMMand Moves the cursor up one physical line. If the 
cursor is Moved above the text window an autoMatic scroll pulls 
down the previous line. To cursor up while the cursor is on the 
first line of the display window and no lines exist above the 
window causes the cursor to be Moved to the beginning of the line 
and an error warning. "CURSOR AT END." 


CTRL. DOWN ARROW 


CURSOR DOWN 


This coMMand Moves the cursor down one physical line. If the 
cursor is Moved below the text window an autoMatic scroll pulls up 
t h e n e x t 1 i n e . To c u r s o r d o w n w h e n t h e c u r s o r i s o n t h e las t line 
of the display window and no lines exist below the window causes 
the cursor to be Moved past the last character in the buffer and an 
error warning, "CURSOR AT END" to be generated. 

j 

CTRL. 2 - MOVE THE CURSOR TO 'BEGINNING OP LOGICAL LINE 

This comm and Moves the cursor to the beginning of the logical 
line. If the cursor Moves above the text window an autoMatic 
scroll occurs hoMing the cursor and the line. No errors can occur. 
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CTRL... 3 - MOVE THE CURSOR TO END OF LOGICAL LINE 


This com ms rid Moves the cursor to the end 
If the cursor Moves below the text window an 
occurs pulling the rest of the line into the 
errors can occur* 


of the logical line. 
autOMatic scroll 
t e x t w .i. n d o w ♦ No 


BACKSPACE 


DELETE LEFT OF CURSOR (IMMEDIATE MODE) 


This comm and deletes the character to the left except possibly 
if the cursor is to the right of a carriage-return* In this case a 
cursor -left is done instead* unless the coluMn to the left of the 
cursor is the CR* If a CR is deleted the two lines will be 
concatenated as long as the new line does not exceed the Maxi mum 
col u m n liMits ♦ If the Maxi mum line length is exceded by this type 
of concatenation the deleted CR is restored* the comm and line is 
aborted with the error "LINE TOO LONG" leaving the user in 
iMMediate Mode. If the cursor is in the Middle of an expanding tab 
the entire tab is deleted* If the cursor is Moved above the text 
window an autoMatic scroll sucks down the previous line. If the 
cursor is already at the beginning of the buffer no operation take 
place except an error warning* "CURSOR AT END." It is illegal to 
delete the last CR in the buffer-if you try you will get the error 
warning* "CURSOR AT END". The only way to delete the last CR in 
the buffer is to use "Delete Line". 


s 


CTRL DELETE - DELETE CHARACTERS TO RIGHT OF CURSOR 
This coMMand deletes the character to the right except 


a c a r r :i. 5! g e - r e t u r n ♦ I n 
unless the coluMn to the 
i s i n t h e m i d die of an 
If a CR is deleted the 
the new line does not 


possibly if the cursor is to the right of 
this case a cursor -right is done instead* 
right begins the new line. If the cursor 
e x p a n d i n g T A B t h e e n t i r e t a b is dele t e d . 
two lines w i 1 1 b e c o n c a t e n a t e d as 1 o n g a s 
exceed Maxi mum coluMn liMits. If the Maxi mum line length is 
exceded by this type of concatenation the deleted CR is restored* 
the coMMand line is aborted with the error "LINE TOO LONG" leaving 
the user in iMMediate Mode. If the cursor is already at the end of 
the text in the buffer no operation takes place except an error 
warning* "CURSOR AT END." It is illegal to delete the last CR in 
the buffer-if you try you will get the error warning* "CURSOR AT 
END". The only way to delete the last CR in the buffer is to use 
"Delete Line". 


SHIFT DELETE - DELETE LOGICAL LINE CURSOR IS ON 


This coMMand deletes the logical line the cursor is on. The 
cursor is positioned before the first character of the next line. 

The last deleted line is stored in the "recover— 1 ine" buffer (see 
coMMand RL). 
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SHIFT INSERT 


PREPARE TO INSERT NEW LINE ABOVE CURRENT ONE 


T h i s eon n a n d a u t o n a t i c a ]. 1 y n o v e s t h e c u r s o r t o t h e b e g i n n i n 9 
of the logical line* inserts a CR and naves the cursor before the 
newly inserted car raige-retur ri ♦ This allows a new line to be 
e n t e r e d b e t w e e n t w o e x i s t i n g 1 i ri e s or a ri e w 1 i n e a d d e d f> b s t t h e 
1 a s t 1 i n e i n t h e b u f f e r ♦ 


CTRL CLEAR 


DISPLAY PREVIOUS SCREEN 


T his c o n n a n d d i s p 1 a y s t h e p r e v i o u s t w e n t y p h y s i c a 1 3. i n e s a b o v e 
t h e t e x t w i n d o w a n d hi o n e s t h e c u r s o r * I f n o t e n o u g h 1 i n e s e x i s t 
a b o v e t h e window * t h e f i r s t t w e ri t y 1 i ri e s w i 3 . 1 b e d i s f> 1 a y e d a n d a n 
error warning* "CURSOR AT END" is generated* 


CTRL* INSERT 


DISPLAY NEXT SCREEN 


This connand displays the next twenty physical lines below the 
t e x t w i n d o w a n d h o n e s t h e c u r s o r ♦ I f n o t e n o u 9 h 1 i n e s e x i s t below 
the window* the last nineteen lines will be displayed and an error 
warning* "CURSOR AT END"* is generated* 


TAP 


INSERT A TAP INTO THE TEXT 


If tabs have been selected to be like the Operating Systen 
Tabs the tab will be replaced by a n under of blanks to nove the 
c u r s or to t h e n e x t t a b s t o f> * 0 n t h e o t h e r h a n d * i f t a b s h a v e b e e n 

s e 1 e c t e d t o b e e x p a n d :i. n g 1 a b s * T h e 1 3 b i <s 3 3. s o i n s e r t e d i n t o t h e 
t e x t * b li t n 3 y t a k e u p n o t v e t h a n o n e c o 3. u n n ♦ 


SHIFT TAP 


TOGGLE VISIPLE-CR-MQDE 


Carriage r e t u r n s c a n e i t h e r b e d i s p 1 a y e d a s b 1 a n k. s or 
down-arrows* This connand switches to the opposite display 
character ♦ 


JM/T* 


I 


I n m e d i a t e m q d e 
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CTRL . TAB 


T 0 G G L E V I S I B L E - T A B - M 0 D E 


This keystroke only functions when expanding tabs have been 
selected* This comm and allows the expanding tabs to be displayed 
i n e i t h e r o f two m e t h o d s ♦ T h e s e e x p a n d i n g t a b f i e 1 d s c a n b e 
displayed with blanks for easy viewing or as a right triangle 
followed by periods for easy edit ting* This coMMand switches to 
t h e o p p o s i. t e d i s p 1 a y m o d e . 


OPTION 


ERASE COMMAND WINDOW 


ENTER COMMAND MODE 


This comm and erases the comm and window and enters the coMMand 
Mode* Following keystrokes will be inputted to the comm and window 
instead of the text window* iMMediate Mode coMMands, except 
backspace can still be executed froM the commshcI Mode* The 
backspace instead will delete the last character typed into the 
coMMand window* 


START 


EXECUTE WHATS IN THE COMMAND WINDOW 


This coMM 3 nd executes the coMMand window if a syntactily 
correct coMMand exists there* After execution the editor is left 
in iMMediste-Mode* Executing a blank comm and or an OMpty display 
w i n d o w will retur n c o n t r o 1 t o t h e i n s e r t Mode* 


SELECT 


SELECT ALTERNATE COMMAND LINE 


Available soon* 
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COMMAND MODE 


>*«• Mtl 


C o m m a n d n o d e r e f e r s t o t r a p p i n g k e y s t r o k e s f o r i n p u t i n t o t h e 
c o m n a n d window i n s t e a d o f t h a t e x t wind o w * A Mi n i - i n t e r p r e t e r 
c h e c k s a f t a r e a c h k a ystr o k e f o r v a 1 i d s y n t a x * t h u s h e 1 p :i. n g t h e u s e r 
to catch errors* Three kinds of Syntax errors can happen* 
"UNRECOGNIZED COMMAND" * "DELIMETER ERROR", or "NUMBER TOO BIG*" If 
a s y n t a x e r r o r s o c c u r s * t h e e d i t o r i g ri o r e s k e y s t r o k e s u ri t i 1 t h e 
o f f a r i d i n g c h a r a c t e r % i s d e 1 e t e d f r o m 1 h e c o m m a n d w i n d o w * 


The comm and window is three lines long > allowing a single 
c o m m a n d 1 i n e m a d e u p o f o n e o r m o r e c: o m m a n d s * T h e 0 P T I (!) N k e y 
e r a s e s t h e e n t i r a a o m m a? n d w i n d o w * w h e r e a B a c k s p a c a ( i n c o m m a n d 
m o d e > del e t e s t h e 1 a s t c h a r a a t e r e n t e r e d i n t o t h e c o m m a n d w i. n d o w ♦ 
T h e S T A R T k e y w i 1 1 e x e c u t e t h e c o m m a n d 1 i n e i f i. t i s s y n t a c t i c 1 y 
c o r r e c t a n d c o m p 1 e t e ♦ A f t e r e x e c u t i o ri c o n t r o 1 i s 1 e f t i n 
I m m e d :i. t a t e m o d e ♦ T h e c o m m a ri d 1 i n e i s n o t e r* a a a d a f t e r- e x a a u t i o ri 
a n d m a y b e r e - e x e c u t e d h y f> r e s s i n g S T A R T a g a i ri ♦ 


CURRENTLY IMPLIMENTED COMMANDS 

X< )K )K X< )K ){< »: )K >K >K W, X< W. y,< X & & >K X. ft )¥. X X £ )K >K ft X ft ft ft X ft ft! X ){< ft ft ft X ft ft X ft ft! ft ft ft ft ft ft ft! ft ft X< ft ft ft ft ft ft ft 


CLr. 

CRn 

CUn 

CDn 

CBB 

CEB 

CBF 

CEF 

CBL 

CEL 

CCn 

DLn 


ft 
% 
ft 
ft 
X< 

)«< 
X 

ac 

)K 

)K 
>K 

DAn ^ 

DR * 

IH 

IT/ string/ n ^ 

OC 3K 

RL ^ 

LMn ^ 

RMn * 

EXIT x 

ABORT 

(space) ^ 


Move 

Move 

Move 

Move 

Move 

Move? 

Move 

Move 

Move 

Move 

Move 


cur so r 
cursor 
cursor 
cursor 
cursor 
cursor 
cursor 
cu rsor 
cursor 
cursor 
cursor 


1 e f t ri c? h a r a a t e r s 
right n characters 
u p ri 1 o g i c a 1 1 i n e s 
down n logical lines 
to beginning of buffer 
to end of buffer 
t o b e g i ri r« i ri g of f i 1 e 
to end of file 

t o b e g i n n i i"i g o f 1 o g i c a 1 1 i n e 

t o e n d o f l o g i a a 1 1 i n e 
to coIumh ri 
d e 1 e t e n 1 o g i c? a 1 1 i n e s 
d e 1 e t a n c h a r a a t e r s b e f o r e c u rsor 
delete n characters after cursor 
d e 1 e t e? r e m a i n d a r o f 1 o g i. c a 1 1 i n e 

i ri p u t h a 1 f o f a v a i 1 a b 1 a r a m f r o m f i 1 e 

i n p u t str i n g n t :L m e => a t c? u r si o r f> o s i t i o n 
o u t p u t t e x t t o f i 1 e u p t o 1 i ri e? c u T' si o r is o n 
recover previously deleted line 
set left Margin to width n 
set right Margin to width n 
exit nornally froM editor 

exit abnorMally froM editor nullifying all edits 
used to Make coMMsnd lines readable 


NOTEJ “n" is an optional nuMeric ergunent that usually acts as 
a repeat counter with a range of 0 -65535 ♦ 


NOTE? "/string/'* is a required character string del ini ted by 
either a pair of slashes or a pair of double quotes* 
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CLr. 


CURSOR LEFT n CHARACTER'S 


This coMMond Moves the cursor left n characters* If "n" is 
OMitted or is zero the value is assuMed to be one* This coMMand 
cursors over tab fields and CR fields in a single bound* If the 
cursor is Moved above the text window auto Mat ic scrolling 
down the next line(s). To cursor left past the beginning 
buffer generates the error "CURSOR AT E N D ‘ 1 and aborts the 
line* leaving the user in iMMediate Mode* 


p u 11s 
of the 
coMMand 


CRn - CURSOR RIGHT n CHARACTERS 


This coMMand Moves the cursor right n characters* If "n" is 
OMitted or is zero the value is assuMed to be one* This coMMand 
cursors over tab fields and CR fields in a single bound* If the 
cursor is Moved below the text window automatic scrolling pulls up 
the next line(s)* To cursor right past the end of the buffer 
generates the error "CURSOR AT E N D 1 1 and aborts the coMMand line# 
leaving the user in iMMediate Mode* 


CUn 


CURSOR UP n LOGICAL LINES 


This coMMand Moves the cursor to the beginning of the logical 
line that precedes the logical line the cursor is on* If "n" is 
OMitted or is zero the value is assuMed to be one* If the cursor 
is Moved above the text window autoMatic scrolling pulls down the 
required nuMfaer of lines* To cursor up past the beginning of the 
buffer generates the error "CURSOR AT E N D ’ 1 and aborts the comm and 
line# leaving the user in iMMediate Mode* 


CDn 


CURSOR DOWN n LOGICAL LINES 


This coMMand Moves the cursor to the beginning of the logical 
line that follows the logical line the cursor is on* If "n" is 
OMitted or is zero the value is assuMed to be one* If the cursor 
is Moved below the text window autoMatic scrolling pulls up the 
required nuMber of lines* To cursor down past the end of the 
buffer generates the error "CURSOR AT END" and aborts the coMMand 
line* leaving the user in iMMediate Mode. 




MODE CURSOR TO BEGINNING OF BUFFER 


This coMMand Moves the cursor before the first text line in 
the buffer* No errors can occur* 


n.»ri||iWH% W i i 
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CEB 


MOVE CURSOR TO END OF BUFFER 


This com «s nd Moves the cursor past the last line in the 
buffer* The screen is cleared leaving only the cursor* Usually 
the user would then use iMMediate "line-insert" to start typing 
additional text or use iMMediate "display prior 20 lines" to 
deter Mine what text is at the end of the buffer* No errors can 
occur ♦ 


CBF 


MOVE CURSOR TO BEGINNING OF FILE 


This comm and Moves the cursor before the first text line in 
the file* 


CEF 


MOVE CURSOR TO END OF FILE 


This comm and Moves the cursor past the last line in the file* 
The screen is cleared leaving only the cursor* Usually the user 
would use iMMediate "line-insert" to start typing additional text 
that would be appended to the end of the file* 


CBL 


MOVE CURSOR TO BEGINNING OF LOGICAL LINE 


This coMMand Moves the cursor to the beginning of the logical 
line* If the cursor is already at the beginning of the line the 
coMMand does nothing* No errors can occur* 


CEL 


MOVE CURSOR TO END OF LOGICAL LINE 


This co mm and Moves the cursor 
If the cursor is already at the end 
nothing* No errors can occur* 


to the end of the logical line* 
of the line the coMMand does 


CCn 


MOVE CURSOR TO COLUMN n 


This coMMand Moves the cursor to the coluMn specified by n* 

If the coluMn specified is greater than the current length of the 
line b u t less t h a n the m a x i. m um 1 i n e 1 e n g t h * t h e 1 i n e i s e x t e n d e d 
with blanks before the CR first* If n is greater than the m a x i m u m 
line length the coMMand aborts with the error warning "NUMBER TOO 
BIG" and leaves the user in iMMediate Mode* 




C o m m a n d M o d e 


10/11/80 
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D L r * 


DELETE: n LOGICAL LINES 


7 h i s c o n m a n d d e 1 e t e s t h e logical 1 i n e t h e c u r s o r i s o n * A f t e r v 

d e 1 e t i o n t h e c u r s o r i s p 1 a c e d b e f o r e t h e f i r s t c h a r a c t e r o f 1 e 

n e x t 1 o g i c a 1 1 i n e ♦ T hi e 1 a s t d e 1 e t e d 1 i n e .i s s 1 o r e d i n t h e 
“recover-- 1 i ne" buffer (see RL comm and)* If "n" is dm i tied or is 

z e r o t h e v a 1 u e i s a s s u m e d t o b e o n e ♦ T o e x e c u t e t hi i is c o m m a n d w h e ri 
the cursor is past the last line in the buffer generates the error 
“ C U K S 0 R A T E N D 1 1 a n d a h o r t s t hi e c o m m a n d 1 i n e * 3. e a v i n g t hi e u s e r i n 
iMMediate Mode ♦ 


DELETE n CHARACTERS BEFORE THE CURSOR 


This comm and deletes n characters before the 
is oMitted or is zero the value is assuMed to be 
d e 1 e t e d t h e e d i. t o r will t r y t o c o n c a t e n a t e t h e 1 i 
m u s t fit wit h i n c u r r e n t 1 i n e 3. e n g t h 3. i m i t s o r t h e 


a b o r t w i t h t h e e r r r o r * 1 1 L I N E T 0 0 L 0 N G “ a n d t hi e u s 
iMMediate Mode* To delete characters before the 
c u i‘* s o r i s a t t h e b e g i n n i ri g o f t h e b u f f e r g e ri e r a t e 
"CURS 0 R A T E N D" a n d a b o r t s t h e c o m m a n d 1 i n e ? 1 e a v 
i m m e d i a t e m o d e * T o d e 1 e t e t h e 1 a s t C R i r» 1 1 ”i e b u f 
e r ror " C U R S 0 R A T E." N D “ a n d a b o r- 1 s t h e c o m m a n d 1 i n e 
in iMMediate Mode* To delete the last CR in the 
Delete-Line coMMand ♦ 


cursor* If "ri" 
one* If a CR is 
n e s ♦ T h e ri e w 1 i n e 
c o m m a n d 1 i n e will 
er is left in 
c u r s o r w h e n t h e 
s the error 
ing the user in 
fer generates the 
* leaving the user 
buffer use the 


DAn 


DELETE n CHARACTERS AFTER THE CURSOR 


T h i c o m m a n d del e t e s ri c h a v acters a f t e r 1 1) e c u r s o r * If 1 1 n “ is 
OMitted or is zero the value is assuMed to be one* If a CR is 
d e 3. e t e d t h e e d i t o r w i !L 3. t r- y t o c o n c a t e r*i a t e t h e 3. i n e <j> * The n e w 3. i n e 
Must fit within current line length liMits or the coMMand line will 
a h o r t w i t h t h e e r r- o r ? "LI. N EL* T 0 0 L 0 N G ‘ ’ a r*i d t h e u s e r J. s 1 e f t i ri 
i m m e d i a t e m o d e ♦ T o d e 1 e t e c h a r a c t e r s a f t e r t h e c u r o r w hi e n t hi e 
cursor is at the end of the buffer generates the error "CURSOR AT 
E: N D " a n d a b o r t s t hi e c o n m a i"i d 3. i i”i e * 1 e a? v i n g t hi e u e r- i i"i i m m e d i. a t e 
m o d e ♦ To del e t e t hi e 1 a? s t C R i n t hi e b u f f e r g e n e r a t e <Ji t h e e r r o t % 

1 1 C U R S 0 R A T E N D " a ri d a b o r t s t hi e c o m m a ri d 1 i n e ? 1 e a v i n g t hi e u s e r i n 
iMMediate Mode* To delete the last CR use the Delete- Line coMMand* 


DRn 


DELETE REMAINDER OF LOGICAL LINE 


This comm n d deletes every character between the cursor 

j 

location arid the CR , except when the cursor is past the CR. If the 
cursor is past the CR the cursor is Moved before the CR arid nothing 
is deleted. 


1 
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IH 


INPUT HALF OF AVAILABLE: RAM FROM FILE 


This eoMMarid calculates free iienory and inputs appr oxiMately 
half that Much froM the file into the buffer. This comm and in 
coMbi nation with OC allows the user to edit files larger than will 
f i t i n m e m o ry. To I H w h e n t h e I N P U T EE 0 F h as air' e a d y b e e n r e a c h e d 
does nothing except to generate an error warning? "INPUT EE OF." If 
too little free MeMory exists the error "MEMORY FULL" is generated 
a i "i d t h e c o m m a n d 1 i n e e x e c u t i o n i s a b o r t e d ? 1 e a v i ri g t h e u s e r i n 
iMMediate Mode. Use OC to free up MeMory. 


IT/str ing/n - INPUT STRING AT CURSOR POSITION n TIMES 

This comm and inserts the string arguMent at the cursor 
location n tiMes. If n is cm it ted or is zero? the value is assuMed 
to be one. If the cursor is past the last line in the buffer an 
autoMatic insertion of a CR to the right of the cursor is done 
before inserting the text. If too little free mom or y exists either 
n o n e o r part o f t h e s t r i n g w i 1 1 b e i n s e r t e d a n d t f t e error "ME M 0 R Y 

FULL" will be generated? aborting the comm and line execution? and 
leaving the user in iMMediate Mode. The cursor is left after the 
last character inserted. 


OC 


OUTPUT TEXT UP TO THE CURSOR 


This co mm and outputs text froM the beginning of the buffer up 
to t h e 1 o g i c a 1 1 i n e t h e c u r s o r i s o n ,* t h e n t h e 1 i n e t h e c u rsor .i s 
on bee ones the first line in the buffer. This comm and in 
coMbi nation with II-I allows the user to edit files larger than will 
f it i n m e m o r y ♦ T h i s c o m m a n d f r e e s u p m e m o r y ♦ 


RECOVER DELETED LINE 


This coMMand inserts the text line stored in the j 

"recover -line" buffer in front of the current line the cursor is 
on. This is used both to recover froM accidently deleting a line 
or as a siMple way to Move one line. Text is inserted into the 
recover -line buffer by either a coMMand or an iMMediate keystroke 
to delete-logical-1 ine . 
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LEFT MARGIN SET 


t 

This command changes the left Margin. This is used in case 
your television is out of ad just Merit- and cuts off coluMns on the 
left side of the display. The left margin may be set from 0 to 5 
column via the n. If "n" is omitted it is assumed to be 0. If " 
is greater than 5 the command is aborted with the error warning 
"NUMBER TOD BIG", and leaves the user in immediate mode. 


"n" 


RMr 


RIGHT MARGIN SET 


This command changes the right margin. This is used in case 
your television is out of adjustment and cuts off columns on the 
right side of the display* The right Margin may be set from 0 to b 
columns via the n* If "n" is omitted it is assumed to be 0. If 
"n" is greater than 5 the command is aborted with the error warning 
"NUMBER TOO BIG", and leaves the user in immediate mode. 


EXIT 


EXIT NORMALLY FROM EDITOR 


This command is the normal exit from the editor. The buffer 
is written and filled repeatedly until the remainder of text is 
t r a n s f e r e d to t h e o u t p u t f i 1 e * T h e n t h e o 3. d , E:' A K f .i .1. e i s d e 1 e t e d , 
the input file is renamed as the new .BAK file, and the output file 
is renamed as the new file. The editor now being done returns to 
DOS. 


ABORT - EXIT ABNORMALLY FROM THE EDITOR 

T h i s c o m m a n d is t h e a b o r m a 1 e x i t f r o m t h e e d i t o r . W A R N I N G - 
this command nullifies all edits done during the current editing 
session. The output file is closed and then deleted, leaving the 
original file and .BAK untouched. ' The editor now being done 
returns to DOS. 


( space ) 


NO OPERATION 


This com M 3 nd does nothing. It is useful 1 to sprinkle in 
between commands when more than one command is placed in the 
command window to make the command window More readable. 


■ .1 .1 : t*—*. - -.e— m 




■,■***• *rr»- ****■■•* 
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PROPOSED FUTURE COMMANDS 

KXXKXXiKXXJKXXXXXXXXKXXXXiKXXXXKXXKXXKXiKXXXXKX *.****)K ****** *********** 


SB/~/l'l 


Search through buffer for nth occurence of string 

Search through file for nth occurence of string 

S e a r c h a n d r e p 1 a c e n t i n e s i n b u f f e r 

S ear c h a n d r e p 1 a c e n t i n e s in file 

Search , replace and verify n tine s in buffer 

Search t replace and verify n tines in file 


BR/-/n 


Clear block-- Marker s froci buffer 
I n s e r t a b 1 o c k - n a r k e r 

Block copy to before logical line cursor is on 
Block nove to before logical line cursor is on 
Block delete 

Block print on systen printer 

Block write or write-out connand window n 

(can delete file too) 

Block read or read-in connand window n 


REOPEN 

EXIT! 

ABORT 1 

IN/-/ 

ON/-/ 

OA/-/ 

F’Lri 

CTSri 

EWn 

RE 

DF 


Re-open editor with sane file 
Exit fron edit, but renain in editor 
Abort fron edit, but renain in editor 
I n p u t f v o n ri e w file 
Output to new file 

Output to new file in append node 
P r i n t n 1 i n e s o n s y s t e n p r .i n ter 
Convert expanding tabs to spaces for n 
Execute window n (nacro) 

Recover error 

Delete first part of line up to cursor 


1 ines 


Repeat groups * Allow repeat groups in connand lines 




PRELIMINARY FORMS REFERENCE MANUAL, REV 2.2 

By - Dale Yocum, 6/26/80 


FORMS is an internal ATARI program which allows the user to produce 
forM3tted text on the ATARI 800. The user prepares his text using either the 

editior in the assenbler or the disk based editior. 

Anyone who is fariiliar with the DEC prograM RUNOFF or any of it's 

decendents will have no problem using FORMS. 


' TEXT FILE FORMAT 

The text file, created using a seperate editior, contains both the 
textual Material plus special coMMands to the FORMS prograM. A line beginning 
with a period is assuMed to be a coMMand and Must Match one of those listed 
in the CoMMand SuMnary. 

(■ 

Usually the text is filled as it is processed. That is, the prograM 
fills a line by adding successive words froM the text file until one More 
word would cause the right Margin to be exceeded. SoMe coMMands cause a break 
in the output. A break Means that no More filling will occur e on the current 
line and the line is output to the printer. This occures, for exaMple, at the 
end of a paragraph. 

Note, only one coMMand can appear per line. 


COMMAND SUMMARY 


« Ctttttt ... 

Center text. Causes a break after which the text tttttt... is centered on the 
following line. tttt... can be no longer than the right-hand Margin set up by 
♦ Wn. 


.D 

Don't fill lines. Causes a break after which the source text is printed 
verbatiM ♦ 


.DO 

Turn on fill Mode again. 



.Fn 

Skip n lines between pages. If n = 0 then issue a forM-feed character between 
pages instead of just blank lines. Default is 8 lines between pages. There is 
o upper liMit on the value of n. 
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- . Hn 

Page height* Changes the nunber of lines per page to n. Value of n can range 
frort 5 to any value. Default is 57 lines. 


. In ' 

Indent lines. Causes a break after 
character position given by n. The 
value of n can range fron 1 to the 
Default value is 1. 


which the left Margin in Moved to the 
right Margin will rewsin constant. The 
MaxiMUM line width (specified by «Wn)-l 


♦ L 

New line. Causes a break 

You May accoMplish the sane function by placing a commb as the first 
character of a line of text. For exanpleJ 

i 

#This line will have a break. 

Will do the sane thing asJ 
.L 

This line will have a break. 


.Ln 

Tkip lines. Causes a break followed by n blank lines. The value of n can 
range fron 1. to any value. 


♦ Nn 

Page nunber ♦ Changes the nunber of the CURENT page to be n. If n is set to 0 
then the printing of page nunbers at the top of each page will be supressed. 
Default is to turn on page nuMber printing. The first' page is page 1. There 
is no MaxiMUM value for n. 


.P 

New paragraph. Causes a break after which one line will be skipped. The next 
line printed will be indented by the nunber of characters specified by .Pn 
below. Default is 5 characters. 


.Pn 

New paragraph and change. Causes a break after which a new paragraph will be 
created as described in . P above. The nuMber of characters indented for this 
and all subsequent paragraphs is given by n. The value of n can range fron 1 
to the MaxiMUM line width - 1. The default value is 5 characters. 


.Q 

n ui t st end of page. The output process will pause at the end of each page to 
^,llow the paper to be changed in the printer. Printing will resuMe when 
RETURN is pressed. This option will renain in force until turned off by «Q0 
below. 
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“.GO 

Don't quit at end of page. Turns off the pause at the end of each page. This 
is the default. 


.Rttttttt . . ♦ 

Remark. The line ttttt... will only appear in the source text file. It will 
not be printed in the final output. There is no Unit on the length of the 
renark string. 


.S 

Skip to top of page. Causes a break after which the systen will leave the 
rest of the current page blank and advance to the top of the next page. 


♦Ttttt... 9 

Title. The string ttttt... will be printed at the top of each subsequent 
page. The title can be up to 80 characters long. It is printed two characters 
after the page nunber ♦ Page numbers Must be enabled to print a title. Default 
is to print nothing. 


.Vr. 

?rtical spacing. Causes a break after which the line spacing is changed to 
11 . For exanple. .V2 will double space the output. Default is single spacing. 


. Wn 

Maxinun line width. Causes a break after which the right-hand nargin is 
changed to n. This is the character position beyond which nothing will be 
printed. Default value is 78. The value of n can range fron 1 to any value. 


10 «,R This is the source text for the 
20 tR FORMS manual as processed by same* 
30 *R Not all commands are used in this 
4*’" *R text* but it should Get the idea 
L *R across* This text was created 
60 *R usinG the EDITIOR/ASSEMBLER 
70 *R cartriGe* FORMS version 1*X will 
80 *R remove the line numbers for you* 

90 ♦ R 

0100 *TF0RMS Reference Manual 

0110 .CPRELIMINARY FORMS REFERENCE MANUAL 

0120 *CE!y - Dale Yocum* 4/18/80 

0130 ♦ L3 

0140 *P 

0150 FORMS is an internal ATARI proGram 
0160 which allows the user to produce 
0170 formatted text on the ATARI 800* 

0180 The user prepares his text usinG 
0190 either the editior in the 
0200 assembler or the disk based 
0210 editior* t 

0220 *P 


0230 
0240 
0250 
0260 
0270 
0280 
P°90 
< JO 
0310 
0320 
0330 
0340 
0350 
0360 
0370 
0380 
0390 
0400 
0410 
0420 
0430 
0440 
0450 
0460 
0470 
0480 
0490 
0500 
0510 
0520 
0530 
0540 
50 
0560 
0570 
0580 
0590 
0600 
0610 
0620 


Anyone who is familiar with the 
DEC proGram RUNOFF or any of it's 
decendents will have no problem 
usinG FORMS. 


. L2 

.CTEXT FILE FORMAT 
*P 

The text filer created usiriG a seperate editior r contains both the textual 

material plus special commands to 

the FORMS proGram* A line beGinninG 

with a period is assumed to be a 

command and must match one of those 

listed in the Command Summary. 

*P 

Usually the text is filled as it 
is processed* That isr the procram 
fills a line by addiriG successive 
words from the text file until one 
more word would cause the riGht 
mar Gin to be exceeded* Some commands 
cause a break in the output* A break 
means 


that no more fillinG will occur e 

on the current line and the line is output to the printer* 
This occuresr for example* at the end 
of a ParaGraph* 

*P 

Note? only one command can appear per line* 


♦ L3 

* CCOMMAND SUMMARY 

. L2 - 


Form 5 

a per'IOO 

Jhti *v/// 
n o+ Oi ** 


. Ctttttt * « ♦ 

♦ L 

Center text* Causes a break after which 
the text tttttt*.. is centered on the followinG line* 
tttt... can be no loriGer than the riGht-hand mar Gin set 

*L2 
» D 


UP 


on )y recoj nrt 
t n CoL J , | 

p g pm tec/ 5 t- 

O & am O’- 

by «Wn* 


* L 

Don't fill lines* Causes a break after which 



0640 12 

0650 .DO 
0660 .L 

0670 Turn on fill mode aGain* 

0680 *L2 
065*0 .Fn 
0" 0 *L 

0/x0 Skip n lines between paGes* If n = 0 
0720 then issue a form-feed character between 
0730 races instead of Just blank lines* 

0740 Default is 8 lines between paGes* 

0750 There is no upper limit on the value of n. 
0760 *S 
0770 *Hn 
0780 ♦ L 

0790 PaGe heiGht* Charges the number of 
0800 lines per pace to n* Value of n can 
0810 ranGe from 5 to any value* Default 
0820 is 57 lines* 

0830 *L2 
0840 .In 
0850 « L 

0860 Indent lines* Causes a break after which 
0870 the left marGin in moved to the character 
0880 position Given by n* The rioht marGin 
0890 will remain constant. 

0900 The value of n can ranGe from 1 to 

0910 the maximum line width (specified by *Wn)-l 

0920 Default value is 1. 

0930 *L2 
0940 ♦ L 

0 r 0 ♦ L 

0v^.0 New line* Causes a break 
0970 *L2 
0980 *Ln 
0990 * L 

1000 Skip lines. Causes a break followed 
1010 by n blank lines. The value of n 
1020 can ranGe from 1 to any value* 

1030 *L2 
1040 *Nn 
1050 «L 

1060 PaGe number* ChanGes the number of 
1070 the CURENT paGe to be n. If n is set 
1080 to 0 then the printinG of pace 
1090 numbers at the top of each paGe will 
1100 be supressed* 

1110 Default is to turn on paGe number 
1120 printinG* The first pace is paGe 1* 

1130 There is no maximum value for n* \ 

1140 *L2 
1150 *P 
1160 *L 

1170 New ParaGraph. Causes a break after 
1180 which one line will be skipped* 

1190 The next line printed will be indented 
l^no by the number of characters specified 
1 0 by *Pn below. Default is 5 characters. 

1220 *L2 
1230 *Pn 
1240 * L 

1250 New ParaGraph and chariGe* Causes a 
1260 break after which a new ParaGraph 
1270 will be created as described in *P 
1280 above. The number of characters indented 


1 j u 0 i£ Given oy ru me value cn n can 

# ^ 

1310 rariGe from 1 to the maximum line width - 1* 

1320 The default value is 5 characters* 

1330 «L2 
1340 .Q 
1350 .L 

J 0 Quit at end of P3Ge. The output 
ls/0 process will pause at the end of each 

1380 PSGe to allow the paper to be charged 
1390 in the printer. Print ins will resume 
1400 when RETURN is pressed. This option 
1410 will remain in force until turned 
1420 off by «Q0 below. 

1430 . L2 
1440 .Q0 

1450 .L 

1460 Don't Quit at -end of pace. Turns 
1470 off the pause at the end of each paee. 

1480 This is the default. 

1490 . L2 

1500 . Rttttttt . . . 

1510 .L 

1520 Remark. The line ttttt... will orils 
1530 appear in the .source text file. 

1540 It will not be printed in the 
1550 final output. There is no limit on 
1560 the leriGth of the remark strinG. 

1570 »L2 
1580 .S 
1590 .L 

1600 Skip to top of PSGe. Causes a break after which 
10 the sastem will leave the rest of 
1^20 the current P3Ge blank and advance 
1630 to the top of the next paGe. 

1640 . L2 ^ 

1650 .Ttttt... 

1660 .L 

1670 Title. The stririG ttttt. ♦♦ will be 
1680 printed at the top of each subseauent 
1690 pace* The title can be up to 80 characters 
1700 lonG. It is printed two characters 
1710 after the pase number. Pace numbers 
1720 must be enabled to print a title. 

1730 Default is to print nothinG. 

1740 *L2 
1750 . Vn 

1760 .L 

1770 Vertical spaciriG. Causes a break after 
1780 which the line spacine is charged 
1790 to n. For example! .V2 will double 
1800 space the output. 

1810 Default is siriGle spacinG. 

1820 . L2 
1830 ♦ Wn 

1840 .L 

1850 Maximum line width. Causes a break 
'"*60 after which the riGht-hand marein 

,.70 is chariGed to n. This is the character 
1880 position beyond which nothinG 
1890 will be printed. Default value 
1900 is 78. 

1910 The value of n can ranee from 1 
1920 to any value. 



